home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Util / F-Fi / Find Stuff ƒ / Find Stuff About next >
Encoding:
Text File  |  1993-10-28  |  10.2 KB  |  244 lines  |  [ttro/ttxt]
  1.                     Find Stuff    v 1.0.2
  2.                 The Ultimate Find Program
  3.                 
  4.                 
  5.                     By: Dave Sugar
  6.                     udsugar@mcs.drexel.edu                
  7.                 
  8.                 
  9. What is Find Stuff?
  10.     Find Stuff is an application that will find your files.  It is
  11.     similar to the Finder's find command but more sophisticated and
  12.     versatile.  You ask, "Why should I use this instead of the finder
  13.     find then?"  Well, because with Find Stuff you can search by 
  14.     multiple parameters at one time and it is faster than the
  15.     finder's find.  You can search for files by partial file name,
  16.     label, type, creator, date created and date modified or any
  17.     combination of the parameters.
  18.  
  19.     Find Stuff is a shareware product, please see the end of this file
  20.     for more info on distribution and registration.
  21.  
  22.  
  23. How to use Find Stuff?
  24.     I hope that I have designed the interface to Find Stuff so that it
  25.     feels very natural and is easy to understand.  (In which case you
  26.     shouldn't even need to read this).  Anyway, when you first launch
  27.     Find Stuff it will bring up a window with buttons and a list of
  28.     mounted volumes.
  29.  
  30.     You choose the volumes you want to search by selecting the
  31.     volume name from the list in the top right of the dialog.  You can
  32.     use the standard selection keys to select the volumes.  Shift
  33.     click to make a continuous selection or Command click to just
  34.     toggle the selection of the current item.  You can choose any
  35.     number of volumes to search.
  36.  
  37.     Then you choose the parameters you want to use to search.  You
  38.     do this by first clicking on the icon.  Once the icon has been
  39.     clicked the 'Parameters' button will be enabled so you can set
  40.     the parameters of that item.  
  41.  
  42.     Once you have selected all the items you want to search by and
  43.     filled in all the parameters for each of them you press the 'Find' 
  44.     button and that will begin the search.
  45.  
  46.     When the search begins a dialog will appear to keep you up to 
  47.     date on the search.  It will give you a list of the files that have
  48.     been found and it will tell you which volume is currently being
  49.     searched. While the search is going on you can click on any of the
  50.     files that have been found and it will show you the path, type,
  51.     and creator of the file.  If you then click 'Show File' the Finder
  52.     will come into the foreground and show you that file.
  53.  
  54.  
  55. So you don't like something?
  56.     Well, first off, check out the Preferences menu.  Many of the
  57.     things that some of my beta testers have complained about I
  58.     have already made into preferences.  Again, these should be
  59.     pretty much self explanatory but I will go into a little detail
  60.     about each of them.   
  61.  
  62.     'When launched Open'- when checked will automatically open one
  63.     of the parameter dialogs when the Find Stuff is launched.  The
  64.     most common use for this is if you usually search for files by
  65.     name.  You would click the 'Name' radio button and that dialog
  66.     would automatically be opened every time the application is
  67.     launched.
  68.  
  69.     'Quit when Main Window is closed'- this will automatically quit
  70.     from Find Stuff when you close the main window.
  71.  
  72.     'Open Parameter Dialog when selected'- will automatically open
  73.     the parameter dialog when you click on one of the icons, instead
  74.     of waiting for you to click on the parameter button.  I made this
  75.     a preference because I don't really like the feel of having them
  76.     automatically come up when the icon is clicked, but I see the
  77.     need to reduce the number of mouse clicks.
  78.  
  79.     'Enter in Parameter dialog begins Find'- this is a nice feature
  80.     that was mentioned.  When you are in a parameter dialog if this
  81.     is checked and you press the enter key (as opposed to just the
  82.     return key to close the dialog) then the find will automatically
  83.     start instead of you having to click the Find button from the
  84.     main window.
  85.  
  86.     'Show found invisible files'- this option will allow you to find
  87.     files that are normally invisible on the Macintosh file system.
  88.     You normally won't need the option unless you are looking for a
  89.     file that you normally can't see.  When an invisible file is found
  90.     Find Stuff will show you the path of the file, but you can not
  91.     select it in the finder.
  92.  
  93.     'Default Volume Selection'- tells Find Stuff what volumes to be
  94.     selected automatically when you first launch it.  If you choose
  95.     'All Volumes' each time Find Stuff is launched all mounted
  96.     volumes will be marked for searching.  'Startup Volume' will
  97.     only select the boot drive to be searched.  'No Volumes' will not
  98.     mark any volumes for searching.  'Local Volumes' will only mark
  99.     volumes on this computer for searching, it won't mark Network
  100.     volumes.
  101.  
  102.     The last thing that you can change is the list of file types and
  103.     creators in the type and creator parameter dialogs.  To do this
  104.     you go to the 'Type/Creator' selection from the Preferences
  105.     menu.  There it gives you a scrolling list of titles and the type
  106.     and creator for each item.  You can add and remove items to
  107.     make a custom list that contains the files that you regularly
  108.     use.
  109.  
  110.     If you have any ideas that you think would make some good 
  111.     additions to Find Stuff feel free to mail them to me and I will
  112.     see what I can do about make additions.
  113.  
  114.  
  115. A bit more about Searching:
  116.     If you want some more info about exactly what you can search
  117.     by then read this section.  
  118.  
  119.     The Name parameters allow you to search by name.  You type in a
  120.     partial file name and then you can choose whether the file you
  121.     are searching for should just contain the partial text, whether
  122.     the name should begin or end with this partial text or if this
  123.     should be the entire file name to search for.  So far this doesn't
  124.     use regular expressions (though that is an idea of something to
  125.     add).
  126.     
  127.     The Label parameters allow you to search by label.  You just
  128.     choose the label which you want to search by.  Right now you can
  129.     only search by one label at a time.  I don't think there is a way to
  130.     all you to search for more than one label at a time, but that is
  131.     something that I thought of adding in, I will see what I can come
  132.     up with for a future version.
  133.  
  134.     The Date Created parameters allow you to search by the creation 
  135.     date of the file.  You give it a date and tell it to look on this
  136.     date, before or after this date.
  137.  
  138.     The Date Modified parameters allow you to search by the date
  139.     the file was last modified.  You give it a date and tell it to look
  140.     on this date, before or after this date.
  141.  
  142.     The Type parameters allow you to search by file type.  You can
  143.     either type in the 4 character type or use the pop-up menu to 
  144.     quickly select a file type.  The menu is completely customizable
  145.     from the Preferences menu the 'Type/Creator' selection.
  146.  
  147.     The Creator parameters allow you to search by the file creator.
  148.     You can either type in the 4 character creator or use the pop-up
  149.     menu to quickly select a creator.  This menu is also completely
  150.     customizable from the Preferences menu the 'Type/Creator'
  151.     selection.
  152.  
  153.     The last thing is the 'Ignore System Folder' button.  When this
  154.     is selected the search will ignore any matches that happen to be
  155.     in the System Folder.  This can be useful if you are looking for
  156.     someting that has a bunch of matches in the System Folder that
  157.     you really don't care about.
  158.     
  159.  
  160. Hidden Features:
  161.     These feature are around just to make navigating around easier 
  162.     and so you can do things quickly without a lot of button clicking.
  163.     
  164.     First option is if you hold down the option key while you click
  165.     on the 'Show File' button in the window that has the list of
  166.     found items this will so you the selected files and quit from
  167.     Find Stuff, leaving the Finder in the foreground.
  168.     
  169.     Second thing is that in the list of found items you can select
  170.     more that one item and when you press the 'Show File' button it
  171.     will show all of the files and they will all be selected.
  172.  
  173.  
  174. Technical Jargon:
  175.     The way that I have done the search is to use the Macintosh
  176.     low-level file function PBCatSearch.  This allows me to do the
  177.     very fast search for the file and it is a very flexible function in
  178.     which I can specify many different parameters to search for.
  179.     Once I find a file with PBCatSearch is go through a secondary
  180.     filter to check for everything else to make sure that I have an
  181.     actual match.  
  182.  
  183.     Find Stuff will only search on volumes that support the 
  184.     PBCatSearch function if a volumes does not support this then
  185.     that volume will not be listed in the volumes that are
  186.     searchable. So far the only volume that I know of that does not
  187.     support PBCatSearch is a unix CAP mounted volume.  But I'm sure
  188.     that there are others.
  189.  
  190.     Find Stuff's user interface was developed using Harmony,
  191.     published by Cedrus Corporation.  For more information, contact
  192.     Cedrus at 1-800-233 7871, or harmony@cedrus.com.
  193.  
  194.  
  195. Bugs:
  196.     If you find any bugs in the program please inform me of what you
  197.     found, your system specifcation, what type of volume you were 
  198.     trying to serach, and how I can duplicate the error.  
  199.     
  200.  
  201. Distribution:
  202.     Find Stuff must be distributed for free and in it's entirety 
  203.     (Find Stuff application and this README file).  It may be placed
  204.     on public and private BBSes, internet, commercial services 
  205.     (like CompuServe, Genie, America Online), and shareware
  206.     distribution disks as long as there is no extra charge for the
  207.     software, just the normal fee for the service.
  208.  
  209.     If you are not sure about your service contact the author via
  210.     e-mail or postal mail at below address.
  211.  
  212.  
  213. Registration:
  214.     Find Stuff is a shareware product and you are encouraged to
  215.     register.  This is a very simple procedure in this case.  All you 
  216.     have to do to register is send a post card with something to
  217.     show me how much you like/dislike the program.
  218.  
  219.     Address registration cards to:
  220.         Dave Sugar
  221.         3718 Norburn Rd
  222.         Randallstown, MD  21133 USA
  223.  
  224.     E-Mail address:
  225.         udsugar@mcs.drexel.edu
  226.  
  227. Very Special Thanks:
  228.     I would like to thank all of the following people for their ideas,
  229.     suggestions and time.  They helped me make Find Stuff as good
  230.     as it is.  I think this is everybody, if I forgot someone I am sorry
  231.     but I am just tired and this has been a very long file to write.
  232.     
  233.         Scott DeLucia     -- interface ideas
  234.         Mike Flynn         -- beta testing and general ideas
  235.         Jim Gilsinn     -- beta testing, ideas and icons
  236.         Stuart Harper     -- ideas and beta testing
  237.         Joe Hicks         -- finding bugs
  238.         Arion Lawrence     -- beta testing and ideas
  239.         Mike Meystel    -- final beta testing
  240.     Dave Slotter -- finding that bug with unmounting volumes
  241.         Duncan Widman     -- beta testing and finding bugs
  242.         Amen Zwa        -- for installing CAP so I could test it
  243.         
  244.